home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / STUTTGART / DATABASE / FRANK / Docs_Docs < prev    next >
Encoding:
Text File  |  1995-09-24  |  9.7 KB  |  184 lines

  1. Frank V3.00 - (C) Copyright 1994-1995 Mike Goatly
  2.  
  3. ..---------------------..
  4.       Introduction.
  5. ''---------------------''
  6.  
  7. Welcome to the latest incarnation of Frank, a non-intelligent language learner.  What that means, is as you talk to him, he learns the words that you use, and what order they can appear in.  So the more you say to Frank, the more he can say back.
  8.  
  9. But what purpose does Frank serve?  I don't really know to tell you the truth.  I suppose if you were a really lonely person, you could hold conversations with him, but beware, because he comes up with some beautiful conversation killers.
  10.  
  11. Why have I spent so long writing a new version, if the existance of Frank is utterly pointless?  Well, for firstly, it was a challenge (is this the 'because it was there' syndrome?) and secondly, because people asked me to.  Yes believe it or not, people actually bothered to email me, telling me how Frank could be improved.  (Thanks, I wouldn't have had the motivation to do this if it wasn't for you.... you only have yourselves to blame!)
  12.  
  13. ..-----------------------------..
  14.       Hardware requirements
  15. ''-----------------------------''
  16.  
  17. Frank was written on a Risc PC 600 (original version), so I can be pretty certain that it will run ok on the new A7000 and Risc PC's.  (i.e. anything that runs RISC OS 3.5 or above.)  Unfortunately, at the time of writing, I haven't been able to check how well it runs on the older machines.  If someone could (e)mail me (my address is given at the end of this document) telling me what, if anything, goes wrong on the older variety of Acorns then I would be most appreciative.
  18.  
  19. ..-------------------..
  20.       Quick start
  21. ''-------------------''
  22.  
  23. If you want to find out what Frank is all about quickly, follow these instructions:
  24. (Note: Frank supports !Help, so you may find it helpful if that is running while you are getting used to Frank.)
  25.  
  26. 1: Go into the 'Vocabs' directory.
  27. 2: Double click on the 'Starter' vocabulary.  If Frank wasn't already loaded,his icon will appear on the icon bar.
  28. 3: Click on Frank's icon (on the icon bar), and the main window will open.
  29. 4: Click in the white box near the bottom of the main window, and the caret should appear in it.
  30. 5: Type something in, and you should be well under way to having a 'conversation' with Frank!
  31.  
  32. ..----------------------------..
  33.       Frank in more detail
  34. ''----------------------------''
  35.  
  36. --The main window
  37.       This is where the conversations will take place.
  38.  
  39.       The four boxes that take up the top half of the window contain yours and Frank's past sentences.  Only the last ten sentences are stored, and they can be viewed using the scroll bar at the side of the boxes, but remember, the latest response always appears in the bottom box, so if you enter a sentence, the scroll bar will need to be as low as it can go, or else you will not see Frank's comment.
  40.  
  41.       Below these boxes is the white text entry box.  If you are trying to write something, and nothing is appearing, make sure the caret is present by clicking in the box.
  42.  
  43.       Underneath this are three icons, from left to right:
  44.             -The Vocabulary icon:
  45.                  Clicking on this leads to the current vocabulary list.
  46.                  Functions can be performed on words from the vocab list.
  47.             -The Quick save icon:
  48.                  This is just a quick route to the save box.
  49.             -The Preferences icon:
  50.                  Clicking on this opens up the preferences window.
  51.  
  52.  
  53. --The preferences window
  54.       This is where you can set Frank up to suit you.
  55.  
  56.       Max. Words:  This is the current maximum number of words that Frank can store in memory.  You can increase it by clicking on the right arrow, or decrease it by clicking on the left arrow.
  57.       Max. Links:  This is the current maximum number of words a word can link to.  You can increase it by clicking on the right arrow, or decrease it by clicking on the left arrow.
  58.  
  59.       Any changes you make to these only come into effect when you next run Frank, and you will be informed as such when you do so.
  60.  
  61.       IMPORTANT NOTE:Frank can get _very_ memory hungry when you increase the max words, and the max links especially.  The reason behind this is due to Frank having to reserve memory for every single possible link, for every single possible word, even if they are unused.  A very rough way to calculate the amount of memory that will be used is to multiply the max. words by the max. links and add 88.  For example, if you were to up Max words to 1000, and Max links to 300, you would have to have (1000*300)+88k=3088k (roughly) of memory free to run Frank!  However, the default (Max words of 300, Max links of 80) only takes up 328k, so as long as you keep to reasonable boundarys, everything
  62. should be ok.
  63.  
  64.       Learning:  When this is off, no new words are added to the vocabulary.
  65. This is mainly useful for when you have created a decent vocab, and you don't
  66. want people filling it with swear words, and other junk.
  67.  
  68.       Comma=full stop:  When this is selected, Frank treats commas as the end
  69. of a sentence (just as he does full stops, exclamations marks and question
  70. marks) so the word following the comma will be able to start a sentence.
  71.       Ignore commas:  When this is selected, Frank will treat commas as a 'junk'
  72. character (see next item).
  73.  
  74.       Junk Characters:  In the box next to the word 'Ignore', you can enter
  75. characters that you don't want appearing in your vocab.  As a default,
  76. ()*$& are all treated as 'junk'.  So when you enter the sentence:
  77.       'Hi Frank!  (I'm Mike)'
  78. The words Frank will learn are:  hi
  79.                                  frank
  80.                                  i'm
  81.                                  mike
  82. Because the brackets are ignored (punctuation is automatically ignored)
  83. If you didn't have the brackets as junk characters, Frank would have learned:
  84.                                  hi
  85.                                  frank
  86.                                  (i'm
  87.                                  mike)
  88.  
  89.       Word linkage:  When this is on, Frank is able to construct sentences
  90. using his knowledge of which words can follow on from others.  If this is off,
  91. Frank just constructs sentences of up to six random words.
  92.  
  93.       Word frequency:  For this function to operate, word linkage needs to be
  94. on as well.  If both are on, Frank takes into acount how often words have been
  95. linked to each other as well.
  96.  
  97.       Save prefs with vocab:  When this is on, the preferences are saved
  98. along with the vocabs.  They are loaded with the vocabularys, and come into
  99. instant effect.
  100.  
  101.       Auto-loaded vocabulary:  You can select which (if any) vocabulary is to
  102. be loaded upon execution of Frank by dragging the desired vocab's icon onto the
  103. import arrow.
  104.  
  105.  
  106. --The vocabulary window
  107.  
  108.       Most of this window is occupied by the vocabulary (surprisingly enough)
  109. You can scroll up and down the list by clicking on the arrows to the left of
  110. the list.  Pressing the left mouse button on them will scroll up/down the list
  111. one at a time, whilst using the right mouse button will zip up and down a page
  112. at a time.
  113.  
  114.      To the right of the list are four icons, from top to bottom:
  115.  
  116.      Correct word icon:  By clicking on this icon, and subsequently on a word,
  117. you can correct a mis-spelt word.
  118.  
  119.      Delete word icon:  By clicking on this icon, and then on a word, you can
  120. perminantly remove a word from the vocabulary.  Beware - there is no 'undelete'
  121.  
  122.      View links icon:  By clicking on this icon, and then on a word, you will
  123. open the word linkage window, where you can perform operations on the word's
  124. link data.
  125.  
  126.      Toggle capitals icon:  By clicking on this icon, and then on any word, you
  127. can toggle whether the given word begins with a capital letter or not.  This is
  128. useful for names and dates, etc,  because all words are stored in a lower case
  129. form.
  130.  
  131.  
  132. --Word linkage window
  133.  
  134.       This is where you can find out which words link onto one another.  Like
  135. the vocabulary list, you can scroll up and down the linked words using the
  136. arrows to the left of the list.
  137.  
  138.       To the right of the list is a set of icons, from top to bottom:
  139.  
  140.       Add link icon:  By clicking on this icon, you open a window that allows
  141. you to add a link from the current word to another word (selected from the
  142. vocabulary window), or an end of sentence command.
  143.  
  144.       Break link icon:  By clicking on this icon, and then on one of the linked
  145. words, you can sever the link between the current word, and the selected one.
  146. If you break all the links in a word, an end of sentence command automatically
  147. appears in the link list.
  148.  
  149.       View links icon:  See the vocabulary window section.  The reason this
  150. icon is in this window too, is so you can follow through possible sentences.
  151.  
  152.       Reset counter icon:  By clicking on this icon and the on a linked
  153. word, you can reset the counter (of how many times that link has been
  154. called) to 1.
  155.  
  156. ..======================..
  157.       Final comments
  158. ''======================''
  159.  
  160.       Well, I realise that this new version will undoubtedly have bugs in it.
  161. I hope they are not too serious, for my sake!  If you spot any, let me know,
  162. and I'll see what I can do.  My method of implementing the vocabulary storage
  163. was completely different to all previous versions, and I didn't think it would
  164. work, to be honest, but it seems to have (just), so that's where I expect most
  165. of the errors to arise.
  166.  
  167.       I hope you enjoy chatting to Frank with, or without friends!
  168.  
  169.       You can contact me thusly:
  170.  
  171.       Email:      M.P.Goatly@herts.ac.uk
  172.       Snail mail: Mike Goatly,
  173.                   20 Ely Road,
  174.                   St. Albans,
  175.                   Herts.
  176.                   AL1 5NA
  177.  
  178.       Cheers!  See you in the next release of Frank!
  179.  
  180.       Mike.
  181.  
  182. ps. If you mailed me during the holidays, I'm sorry that I didn't reply -
  183. my mail box went unchecked, and it's probably been wiped, now I'm returning
  184. to uni!